home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / rp_260.zip / REGPRO.DOC < prev    next >
Text File  |  1992-11-15  |  52KB  |  1,093 lines
  1. ─────────────────────────────────────────────────────────────────────────────
  2.  
  3.         The Definitive User Questionnaire/Online Entry Form Door!
  4.  
  5.              ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄
  6.              ▒▒█▀▒▒█ ▒▒█▀▀▀▀ ▒▒█▀▀▀▀ ▒▒█▀▒▒█ ▒▒█▀▒▒█ ▒▒█▀▒▒█
  7.              ▒▒▒▒▒█▀ ▒▒▒▒▒▄  ▒▒█▒▒▒▄ ▒▒▒▒▒▒█ ▒▒▒▒▒█▀ ▒▒█ ▒▒█
  8.              ▒▒█▀▒▒▄ ▒▒█▀▀▀  ▒▒█ ▒▒█ ▒▒█▀▀▀▀ ▒▒█▀▒▒▄ ▒▒█ ▒▒█
  9.              ▒▒█ ▒▒█ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒█ ▒▒█     ▒▒█ ▒▒█ ▒▒▒▒▒▒█
  10.               ▀▀  ▀▀  ▀▀▀▀▀▀  ▀▀▀▀▀▀  ▀▀      ▀▀  ▀▀  ▀▀▀▀▀▀
  11.                 ┌───────────────────────────────────────┐
  12.             ▓███│   V  E  R  S  I  O  N   2  .  6   0   │▓███
  13.                 │                                       │
  14.             ▓███│        Release Date 14 Nov 1992       │▓███
  15.                 └───────────────────────────────────────┘
  16.                    (C) 1991, 1992 Cairo Research Labs
  17.                           ALL RIGHTS RESERVED
  18.  
  19. ─────────────────────────────────────────────────────────────────────────────
  20.  ┌───────────────────────┐
  21. ▄│   Table of Contents   │
  22. █└───────────────────────┘
  23. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  24.  
  25.         1. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . .
  26.              Words From the Authors . . . . . . . . . . . . . . . . . .
  27.              Features . . . . . . . . . . . . . . . . . . . . . . . . .
  28.              What's New in This Release?. . . . . . . . . . . . . . . .
  29.              Licensing and Distribution . . . . . . . . . . . . . . . .
  30.              The Demo Version . . . . . . . . . . . . . . . . . . . . .
  31.              Benefits of Registering. . . . . . . . . . . . . . . . . .
  32.              Ordering RegPRO. . . . . . . . . . . . . . . . . . . . . .
  33.  
  34.         2. GETTING STARTED  . . . . . . . . . . . . . . . . . . . . . .
  35.              System Requirements  . . . . . . . . . . . . . . . . . . .
  36.              Installation . . . . . . . . . . . . . . . . . . . . . . .
  37.  
  38.         3. OPERATION. . . . . . . . . . . . . . . . . . . . . . . . . .
  39.              Control File Options . . . . . . . . . . . . . . . . . . .
  40.              Basic Questionnaire Definitions. . . . . . . . . . . . . .
  41.              Field Flags and Settings . . . . . . . . . . . . . . . . .
  42.              Format Masks (Strings) . . . . . . . . . . . . . . . . . .
  43.              User Edit Keys . . . . . . . . . . . . . . . . . . . . . .
  44.              Sysop Keys . . . . . . . . . . . . . . . . . . . . . . . .
  45.              Command Line . . . . . . . . . . . . . . . . . . . . . . .
  46.  
  47.         4. MISCELLANEOUS. . . . . . . . . . . . . . . . . . . . . . . .
  48.              Tips on Designing RegPRO Screens . . . . . . . . . . . . .
  49.              What's Next? . . . . . . . . . . . . . . . . . . . . . . .
  50.              Special Thanks . . . . . . . . . . . . . . . . . . . . . .
  51.              Upgrades and Information . . . . . . . . . . . . . . . . .
  52.  
  53. ────────────────────────────────────────────────────────────────────────────
  54. ■ INTRODUCTION ■
  55. ────────────────────────────────────────────────────────────────────────────
  56.  
  57. RegPRO is a user questionnaire door for use with most major BBS systems.
  58. Although there are several questionnaire doors available today, we think you
  59. will find RegPRO to be quite a bit different.
  60.  
  61.  ┌───────────────────────────┐
  62. ▄│   Word From The Authors   │
  63. █└───────────────────────────┘
  64. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  65.  
  66. RegPRO started out as a wimpy little questionnaire door, which ran only in
  67. line mode.  Since it's creation, we have received quite a bit of positive
  68. feedback from users around the world, and have done our best to incorporate
  69. user suggestions and enhancements into the package.
  70.  
  71. Currently, the RegPRO Screen Designer (RSD) is under development.  This is
  72. but one of the many enhancements and additions planned for the RegPRO system.
  73.  
  74. Care to show your questionnaires off to the rest of the world?  Send them
  75. our way!  If we like it, we may even include in the SAMPLE.ZIP archive, for
  76. the next release of RegPRO!
  77.  
  78. Should you experience any problems with the RegPRO system, by all means,
  79. get in touch with us!  We can be found in the DOORWARE echo, as well as on
  80. our support BBS (see end of this documentation for more information on how
  81. to get in touch with us).
  82.  
  83.  ┌─────────────┐
  84. ▄│   Features  │
  85. █└─────────────┘
  86. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  87.  
  88. RegPRO didn't become the world's premier user questionnaire door for nothing!
  89. It's features include:
  90.  
  91.         * Custom entry forms, complete with custom fields, formatting masks,
  92.           and much more! (Requires ANSI)
  93.         * Complete support for ASCII users as well.
  94.         * Multinode Compatible!
  95.         * DESQview aware!
  96.         * The most configureable questionnaire door around!
  97.         
  98.  ┌────────────────────────────────┐
  99. ▄│   What's New in This Release?  │
  100. █└────────────────────────────────┘
  101. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  102.         
  103.         * If you do not define your fields long enough to hold a metavariable
  104.           RegPRO would blow up with an error.  The documentation and sample
  105.           .CTL files have been adjusted to cover this area.
  106.  
  107.         * Added ability to "overlay" forms on top of ANSI screens, adding
  108.           dramatic effects to your forms.  This is now demonstrated in the
  109.           sample enclosed in the distribution archive.
  110.  
  111.         * Added ability to generate customized logfile names.  The default
  112.           logfile name is still REGPROx.LOG.
  113.  
  114.         * New BBS drop file formats supported:
  115.  
  116.             - QBBS 2.75 EXITINFO.BBS
  117.             - Remote Access Extended EXITINFO.BBS
  118.  
  119.         * Two new metavariables added:  User's Handle (&HANDLE)
  120.                                         User's Password (&PASSWORD)
  121.  
  122.         * RegPRO now stores the current directory upon entry, and will
  123.           restore it upon exit.
  124.  
  125.         * RegPRO now makes use of its own environment variable to find its
  126.           data and system files (SET REGPRO=C:\DOORS\REGPRO, etc).
  127.  
  128.  ┌────────────────────────────────┐
  129. ▄│   Licensing and Distribution   │
  130. █└────────────────────────────────┘
  131. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  132.  
  133.    This documentation, programs, and other files distributed in this software
  134.    package (the "Software") are the copyrighted property of Scott Burkett,
  135.    Christopher Brown, and Cairo Research Labs.  All rights are reserved.
  136.  
  137.    For use by corporations, institutions or goverment agencies, or for-profit
  138.    purposes, contact the Author for licensing information.
  139.  
  140.    U.S. GOVERNMENT INFORMATION
  141.  
  142.    The use, duplication, or disclosure by the U.S. Government of the Software
  143.    is subject to the restricted rights applicable to commercial software that
  144.    are specified in the subdivision (b.3.ii) of the 'Rights in Technical Data
  145.    and Computer Software' clause, document DFARS 52.227-7013.
  146.  
  147.    DISTRIBUTION/USAGE
  148.  
  149.    RegPRO can be freely distributed, provided that the original archive
  150.    is not changed in any way (other than changing the archive type) and no
  151.    amount of money is required. In no circumstance at all can RegPRO be
  152.    modified without written consent from the authors.  It is prohibited too
  153.    to include this program, whole or in part, in other software.  It is
  154.    expressly forbidden to distribute a registered key to unregistered users.
  155.  
  156.    RegPRO can be used in commercial organizations only after regular
  157.    registration.
  158.  
  159.    This license is considered accepted if the program is used.  Its violation
  160.    will involve the withdrawal of the registration key and the rights to use
  161.    the program.
  162.  
  163.    WARRANTY DISCLAIMER
  164.  
  165.    The Author cannot and does not warrant that any functions contained in the
  166.    Software will meet your requirements, or that its operations will be error
  167.    free.  The entire risk as to the Software performance or quality, or both,
  168.    is solely with the user and not the Author.  You assume responsibility for
  169.    the selection of the program to achieve your intended results, and for the
  170.    installation, use, and results obtained from the Software.
  171.  
  172.    The Author makes no warranty, either implied or expressed, including with-
  173.    out limitation any warranty with respect to this Software documented here,
  174.    its quality, performance, or fitness for a particular purpose. In no event
  175.    shall the Author be liable to you for damages, whether direct or indirect,
  176.    incidental, special, or consequential arising out the use of or any defect
  177.    in the Software, even if the Author has been advised of the possibility of
  178.    such damages, or for any claim by any other party.
  179.  
  180.    All other warranties of any kind, either express or implied, including but
  181.    not limited to the implied warranties of merchantability and fitness for a
  182.    particular purpose, are expressly excluded.
  183.  
  184.    LIMITATION OF REMEDIES
  185.  
  186.    The information contained in the documentation for the Software is subject
  187.    to change without notice.
  188.  
  189.    The Author's entire liability, and your exclusive remedy shall be: (1) the
  190.    replacement of an original Software diskette not meeting the above Limited
  191.    Warranty and which is returned to the Author along with proof of purchase,
  192.    or (2), if the Author is unable to deliver a replacement diskette which is
  193.    free of defects, you may terminate the License Agreement by returning this
  194.    Software and the corresponding license fee will be returned.
  195.  
  196.    By using the Software, you acknowledge (1) to have read and understood all
  197.    parts of this document and (2) to have agreed with and accepted all of its
  198.    provisions without any reservation.
  199.  
  200.                                           Scott Burkett
  201.                                           Christopher Brown,
  202.                                           Cairo Research Labs
  203.  
  204.  ┌──────────────────────────────┐
  205. ▄│   Benefits of Registration   │
  206. █└──────────────────────────────┘
  207. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  208.  
  209. Benefits of registering RegPRO:
  210.  
  211.         o Extended Tech Support via the SPHINX echo (our support echo).
  212.  
  213.         o You will also be entitled to free upgrades to newer versions of
  214.           RegPRO, as they become available. In addition to the great
  215.           many features and the quality that this version of RegPRO has
  216.           to offer, we are currently working on several additions and
  217.           enhancements for future versions.
  218.  
  219.         o The price!  Compared to the other, higher-priced, questionnaire
  220.           doors, You will find that RegPRO is quite a bit cheaper, and a lot
  221.           more powerful.  Most of these doors range in price from $15 to $25,
  222.           and are no where near as powerful as RegPRO.  For only $10, you
  223.           can outperform them all!
  224.  
  225.  ┌─────────────────────┐
  226. ▄│   Ordering RegPRO   │
  227. █└─────────────────────┘
  228. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  229.  
  230. Below are detailed instructions for registering RegPRO. These
  231. instructions are not intended to seem confusing or complicated; they are
  232. simply meant to answer almost any question that you might have about
  233. registering.  If you have any questions or uncertainties about your
  234. registration, please feel free to contact us.  For information on how to
  235. contact us, please see the section on "Upgrades and Information".
  236.  
  237. To order RegPRO, simply follow these three steps:
  238.  
  239.   1.)  Fill out the registration form. Information on filling out
  240.        the form is located in the next section.
  241.  
  242.   2.)  Enclose the appropriate payment ($10), Ten American Dollars,
  243.        payable in the form of cash, check or money order.  Make all checks
  244.        or money orders payable to:  SCOTT BURKETT
  245.  
  246.   3.)  Send the above two items to:
  247.  
  248.                           Cairo Research Labs
  249.                           1113 29th Street
  250.                           Columbus, GA 31904
  251.  
  252.  
  253. FILLING OUT THE REGISTRATION FORM
  254. --------------------------------------------------------------------------------
  255.  
  256. NO PRINTER?    Alternatively, if you do not have a printer, simply send a
  257.                hand-drawn version of the order form.  If you do not wish to
  258.                mail a registration form in, you may opt to upload it to our
  259.                support BBS at (706) 596-8126 (9600v.32).  We will not present
  260.                you with a registration key, however, until proper payment
  261.                has been rendered.
  262.  
  263.                If you have any special instructions for us, or anything that
  264.                you would like to say when you register, feel free to write
  265.                this down on the back of the registration form, or on a
  266.                separate piece of paper.
  267.  
  268.                When filling out the RegPRO registration form, be sure to
  269.                indicate how you would prefer to receive your RegPRO
  270.                registration key. You will have the choice of receiving your
  271.                registration key by one of three means: A call to our BBS,
  272.                FidoNet CrashMail, or by a call to your BBS.  If you have a
  273.                FidoNet Email address, FidoNet CrashMail is still by far the
  274.                quickest way to receive your order. Once you have decided
  275.                which means you would prefer to receive your order by, please
  276.                read the detailed instructions on your order method below.
  277.  
  278. --------------------------------------------------------------------------------
  279. RECEIVING      In order to receive your RegPRO registration key by a
  280. BY CALL        message and/or upload to your BBS, fill out the order form and
  281. TO BBS         mail it along with your payment as described below. Be sure to
  282.                include the phone number, baud rate, and our login and
  283.                password for the BBS to which you would like us to call.  We
  284.                will cover any long distance costs. If, for some reason, we
  285.                are unable to connect to your BBS (not because it busy, but,
  286.                for example, if your BBS is no longer online), we will place
  287.                your key in a message on our support BBS.
  288.  
  289. --------------------------------------------------------------------------------
  290. RECEIVING      In order to receive your RegPRO registration key via
  291. ORDER BY       FidoNet CrashMail, simply fill out the order form and mail it
  292. FIDONET        along with your payment as described below.  Be sure to
  293. CRASHMAIL      include the FidoNet node address to which you wish to have
  294.                your order sent.
  295.  
  296.  
  297. ────────────────────────────────────────────────────────────────────────────
  298. ■ GETTING STARTED ■
  299. ────────────────────────────────────────────────────────────────────────────
  300.  
  301.   RegPRO is a snap to get up and running (as you will see).
  302.  
  303.  ┌────────────────────────┐
  304. ▄│   System Requirements  │
  305. █└────────────────────────┘
  306. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  307.  
  308.   RegPRO was designed for use with IBM compatible personal computer systems,
  309. with 640K minimum RAM.  It will run under most popular BBS packages, to
  310. include RemoteAccess, Maximus, SuperBBS, QuickBBS, GAP, PCBoard, WildCat!,
  311. WWIV, and others.
  312.  
  313.  ┌─────────────────┐
  314. ▄│   Installation  │
  315. █└─────────────────┘
  316. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  317.  
  318. First things first:
  319.  
  320. Create a directory to hold the RegPRO system.  We recommend using something
  321. like C:\REGPRO.  Next, copy the RP_260.EXE file into the directory
  322. and type "RP_260" at the DOS prompt.  The archive is self-extracting and will
  323. come apart without much effort.
  324.  
  325. ** Note:  Your source for obtaining the RegPRO archive may have changed
  326. the format of the archive to one suitable for use on their system (i.e. ZIP,
  327. LZH, ARJ, etc).
  328.  
  329. Next thing on the list is to set the REGPRO environment variable to the path
  330. of the RegPRO files.  Place a SET command in your autoexec.bat file:
  331.  
  332.                   example:  SET REGPRO=C:\REGPRO
  333.                   
  334. The directory specified by the REGPRO environment variable is utilized by
  335. RegPRO to find it's files (registration key, data files, questionnaire files,
  336. etc).  This environment variable must be set in order for RegPRO to operate
  337. efficiently.
  338.  
  339. ────────────────────────────────────────────────────────────────────────────
  340. ■ OPERATION ■
  341. ────────────────────────────────────────────────────────────────────────────
  342.  
  343. If the user is using ANSI mode, he will be presented with a full screen,
  344. customized entry form.  He will have full range of movement between fields
  345. by using either TAB/SHIFT-TAB or his cursor keys to maneuver.  While editing
  346. in each field, he will have a complete range of editing keys at his disposal.
  347. Of course, if the user is in ASCII mode, then RegPro 2.0 will operate in
  348. much the same manner that v1.10 did, i.e. in line mode.
  349.  
  350. Each questionnaire you will design will require a separate .CTL file.  Each
  351. of these control files will include a complete form definition for your
  352. custom entry forms and questionnaires.  This is where RegPRO begins to shine
  353. over other questionnaire doors. 
  354.  
  355.  ┌──────────────────────────┐
  356. ▄│   Control File Options   │
  357. █└──────────────────────────┘
  358. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  359.  
  360. Here we will discuss each of the parameters and options in more detail:
  361.  
  362.  
  363. LOGPATH         This option simply specifies where each questionnaire answer
  364.                 file will be placed.  The logfile will be in the format of
  365.                 "REGPROxx.LOG", where "xx" is the node number.
  366.  
  367.                         i.e. LOGPATH C:\BBS\LOGS
  368.  
  369. LOGNAME         This option will specify the name of the questionnaire answer
  370.                 file that will be created for this form.  You may use the '#'
  371.                 symbol to substitute the node number, thus allowing separate
  372.                 log files for each node of your BBS.  If this keyword isn't
  373.                 specified, then the a default logfile name of REGPROx.LOG
  374.                 will be created, with 'x' being the node number.
  375.  
  376.                         i.e. LOGNAME NEWUSER#.LOG
  377.  
  378. LINKFORM        This keyword instructs RegPRO to go directly into another
  379.                 entry form when the user is finished with the current one.
  380.                 This is extremely handy for processing longer sets of entry
  381.                 forms, or, if you have a lot of text associated with each
  382.                 field, you can put each of the fields in a separate form!
  383.  
  384.                         i.e. LINKFORM NEWUSER2
  385.  
  386.                 ** NOTE ** Do not put an extension on the end of the name of
  387.                 the form to link to!  RegPRO assumes .CTL with these forms,
  388.                 just as it does with the primary form.
  389.  
  390. DOORTYPE        This option will specify the type of dropfile your BBS is
  391.                 using to call RegPRO.  Valid parameters include:
  392.  
  393.                 DORINFO      = DORINFO?.DEF (Standard DORINFOx.DEF Drop file)
  394.                 EXITINFO     = EXITINFO.BBS (RA v.01 - v.04)
  395.                 RA1EXITINFO  = EXITINFO.BBS (Extended (RA v1.0 or greater))
  396.                 CHAIN        = CHAIN.TXT    (WWIV)
  397.                 SFDOORS      = SFDOORS.DAT  (SpitFire BBS)
  398.                 CALLINFO     = CALLINFO.BBS (WildCat!)
  399.                 DOORSYS      = DOOR.SYS     (GAP/PC-Board)
  400.                 QBBS275      = EXITINFO.BBS (QBBS 2.75 or greater)
  401.                 
  402.                 i.e. DOORTYPE CALLINFO
  403.  
  404. SHOWBEFORE      These two keywords allow you to specify ANSI/ASCII screens
  405. SHOWAFTER       to display to the online user either before or after form
  406.                 processing begins.  You may have up to 5 each, per form.
  407.                 Examples of these keywords can be found in the SAMPLE.ZIP
  408.                 archive.
  409.  
  410.                         i.e. SHOWBEFORE WELCOME
  411.                         i.e. SHOWAFTER  THANKS
  412.  
  413.                 ** NOTE ** Do not include an extension, as RegPRO will make
  414.                 the determination of the extension based on the user's ANSI
  415.                 setting.  RegPRO will expect both an .ANS and an .ASC version
  416.                 of the screens in the RegPRO directory.
  417.  
  418. OVERLAY         This option will simply display an ANSI file to both the
  419.                 local and remote screens, right before the form is displayed
  420.                 and processed.  This allows you to place "freetext" on the
  421.                 screen, independant of the form fields themselves.  By using
  422.                 this method, you can create some rather elaborate screen
  423.                 designs, as demonstrated in the RegPRO newuser sample setup.
  424.  
  425.                         i.e. OVERLAY TEMPLATE
  426.  
  427.                 ** NOTE ** No .ANS extension is necessary, since this option
  428.                 will only affect ANSI users.
  429.  
  430. USEBUTTONS      When the user reaches the bottom of the form, a "button"
  431.                 will appear.  This button can contain whatever text you wish
  432.                 to specify, and will serve as a last chance for the user to
  433.                 make changes to his entries.  ** BUTTONS ARE ONLY ACTIVE
  434.                 IF THE USER IS IN ANSI MODE! **
  435.  
  436.                 Place the USEBUTTONS keyword in your .CTL file to enable
  437.                 this option.  If the user has skipped a field marked as
  438.                 "unskippable", then pressing ENTER at the button will not
  439.                 complete the form, rather, RegPRO will place the user at
  440.                 the first skipped field.  RegPRO will *NEVER* process a form
  441.                 if there are unskippable fields which are empty.
  442.  
  443.                 Currently, the only place that RegPRO supports buttons is at
  444.                 the end of your form (it is actually considered as the last
  445.                 field of your form, internally).  However, there are plans
  446.                 to provide configureable buttons for your customization.
  447.  
  448. BUTTONTYPE      This keyword specifies which style of buttons you wish to
  449.                 use.  Note that this (nor any of the other BUTTON keywords)
  450.                 will have no effect unless the USEBUTTONS keyword is enabled.
  451.  
  452.                        1 -┌──────────┐
  453.                           └──────────┘
  454.  
  455.                        2 -╒══════════╕
  456.                           ╘══════════╛
  457.  
  458.                        3 -╓──────────╖
  459.                           ╙──────────╜
  460.  
  461.                        4 -╔══════════╗
  462.                           ╚══════════╝
  463.  
  464.                        5 -Metallic Boxes (Try these!)
  465.  
  466.  
  467.                        i.e. BUTTONSTYLE 3
  468.  
  469. BUTTONCOLORx    This set of keywords will define the color attributes for
  470.                 the button.
  471.  
  472.                 BUTTONCOLOR1 - Color of the border on the button
  473.                 BUTTONCOLOR2 - Only used when Mettalic Boxes are in effect
  474.                 BUTTONCOLOR3 - Normal Button Text Color
  475.                 BUTTONHILITE - Highlighted Button Text Color
  476.  
  477.                 (examples:)
  478.  
  479.                 BUTTONCOLOR1 25
  480.                 BUTTONCOLOR2 16
  481.                 BUTTONCOLOR3 25
  482.                 BUTTONHILITE 31
  483.  
  484.                 ** The values for the colors are contained in the sample
  485.                 control file! **
  486.  
  487. BUTTONTEXT      This option specifies the text to display on the button
  488.                 itself.
  489.  
  490.  
  491.                         i.e. BUTTONTEXT Continue?
  492.  
  493. BUTTONROW       These two keywords specify the row and column that the
  494. BUTTONCOL       button will appear when the user hits the bottom of the
  495.                 form.  It may appear anywhere on the display.
  496.  
  497.                         i.e. BUTTONROW 16
  498.                              BUTTONCOL 25
  499.  
  500.  ┌────────────────────────────────┐
  501. ▄│   Basic Question Definitions   │
  502. █└────────────────────────────────┘
  503. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  504.  
  505. Each question (or field) you design for use with RegPRO can be completely
  506. customized.  Please note that most of these customizations will only be in
  507. effect if the user is in ANSI mode.  This is due to the fact that RegPRO
  508. uses ANSI control sequences heavily in order to allow a full range of
  509. movement within your form or questionnaire.
  510.  
  511. Each field definition begins with the FIELDDEF keyword and ends with the
  512. ENDDEF keyword.  All customization options will appear between the two
  513. keywords (for each field).
  514.  
  515.  
  516. QROW            This specifies the physical row on the screen at which the
  517.                 field will appear (normally 1 through 25).
  518.  
  519.                         i.e. QROW 5
  520.  
  521. QCOL            This specifies the physical column on the screen at which
  522.                 the field will appear (normally 1 through 80);
  523.  
  524.                         i.e. QCOL 1
  525.  
  526. QCOLOR          This is the color of the question text for this field.
  527.  
  528.                         i.e. QCOLOR 14
  529.  
  530. QDESC           This is the actual text associated with this field.
  531.  
  532.                         i.e. QDESC Enter your Real Name Please:
  533.  
  534.                 You may specify this keyword up to 20 times per field, to
  535.                 provide multiline question descriptions.
  536.  
  537.                         i.e. QDESC Now, you must enter your real name!
  538.                              QDESC Please be honest!
  539.                      
  540. AROW            These three keywords are used to determine the row and column
  541. ACOL            for the actual entry field.  The AROW and ACOL keywords are
  542. AFTER           used in the same format as the QROW and QCOL keywords above.
  543.                 The AFTER keyword is a little shortcut, which comes in handy.
  544.                 Most of your fields will look something like this:
  545.  
  546.  
  547.                         Enter your Name: ▒▒▒▒▒▒▒▒▒▒▒▒▒
  548.  
  549.                 By specifying the AFTER keyword, the actual entry field will
  550.                 be placed one character following your field text, thus
  551.                 saving you from having to figure out the coordinates
  552.                 yourself.
  553.  
  554. ACOLOR          This keyword designates the color of the user's answers,
  555.                 while it is *NOT* the current field.
  556.  
  557.                         i.e. ACOLOR 10
  558.  
  559. HILITE          This keyword designates the color of the entry field and
  560.                 text while the user is editing a field.
  561.  
  562.                         i.e. HILITE 15
  563.  
  564. FILL            This particular keyword allows you to specify the "fill"
  565.                 character for each entry field.  You can achieve some pretty
  566.                 nifty efffects with this one.  To get high speed entry fields
  567.                 which look like:
  568.  
  569.                         City: ▒▒▒▒▒▒▒▒▒▒▒▒▒
  570.  
  571.                 Simply place:
  572.  
  573.                         FILL ▒
  574.  
  575.                 in your control file! ;-)
  576.  
  577. FORMAT          This field is used to specify a "format mask" for the field.
  578.                 You may have seen some BBS doors or DOS applications which
  579.                 have entry fields like:
  580.  
  581.                         Home Phone: (123)456-7890
  582.  
  583.                 With this keyword, your online questionnaires can have them
  584.                 too!  Another section in the manual will cover this in a
  585.                 bit more detail.  But for now, just remember that it is
  586.                 available for you.
  587.  
  588.  ┌──────────────────────────────┐
  589. ▄│   Field Flags and Settings   │
  590. █└──────────────────────────────┘
  591. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  592.  
  593. Each of your entry fields can have a certain number of "flags", or settings,
  594. associated with them.  Here they are:
  595.  
  596. NORMAL          This keyword is the default setting, which specifies that no
  597.                 other active flags are active.  This is only useful if you
  598.                 have only one field, since most entry forms will contain
  599.                 several fields, which will be edited in an entry form style.
  600.  
  601.  
  602. NOREDRAW        When set, prevents RegPRO from re-drawing the input string
  603.                 and field when it starts up and exits. If you set this flag,
  604.                 the ACOLOR and HILITE color should contain the same value.
  605.                 If your FILL character is not a space (default), you must
  606.                 use this keyword on the field, so that RegPRO can draw the
  607.                 background for you.  Also, if you are using the EDITSTRING
  608.                 keyword (allows you to specify default answers), you must
  609.                 use this keyword so that RegPRO can display the text as the
  610.                 user enters the field.
  611.  
  612. FIELDMODE       Setting this flag specifies that RegPRO should operate in
  613.                 "field" input mode. In field input mode, the user may finish
  614.                 entering their input by pressing the previous field or next
  615.                 field button (arrow keys, tab keys, etc.), as described later.
  616.                 If you do not specify this field, then RegPRO will assume
  617.                 that the current field is the ONLY field.  Since most of
  618.                 your entry forms will contain more than one field, you
  619.                 really have no need for this one.
  620.  
  621. NOWIPEOUT       This flag will stop RegPRO from "wiping" out fields as the
  622.                 user moves back and forth between them.  There is really
  623.                 no practical reason to leave it out.  
  624.  
  625. EDITEXISTING    Setting this flag specifies that this field will contain a
  626.                 pre-existing string, instead of starting with a blank string.
  627.                 This string may contain whatever you like.  The NOWIPEOUT
  628.                 flag will have no effect on fields with this flag turned on,
  629.                 since these fields are automatically set for "no wipeout".
  630.  
  631.                 i.e. EDITEXISTING Be Honest!
  632.  
  633.                 Starting with version 2.20, you may also use "metavariables"
  634.                 with the EDITEXISTING flag.  Metavariables provide a handy
  635.                 way of stuffing your entry fields with default values from
  636.                 your BBS.  Currently the following metavariables are
  637.                 supported:
  638.  
  639.  
  640.                 Metavariable     Meaning
  641.                 -----------------------------------------
  642.                               |
  643.                 &NAME         | Name of current online user
  644.                 &LOCATION     | Location of current online user
  645.                 &SYSOP        | Name of Sysop (you!)
  646.                 &SYSTEMNAME   | Name of your BBS
  647.                 &PASSWORD     | User's Current Password
  648.                 &HANDLE       | User's Handle or Alias
  649.  
  650.                 You use these metavariables just as you would any other
  651.                 default string:
  652.  
  653.                 i.e. EDITEXISTING &SYSOP
  654.  
  655.                 ** NOTE ** If the field format mask is not long enough to
  656.                 contain the entire metavariable, then RegPRO will produce
  657.                 an error message and exit.  For example, if you had a field
  658.                 called "City:", and its format was "*****", you would get
  659.                 an error when the user moves into the field. As you can see,
  660.                 5 characters (*****) is not long enough to hold a normal
  661.                 user location field.  Here are some recommended field
  662.                 lengths:
  663.  
  664.                         &NAME - 39
  665.                         &LOCATION - 25
  666.                         &SYSOP - 39
  667.                         &SYSTEMNAME - 39
  668.                         &PASSWORD - 15
  669.                         &HANDLE - 35
  670.  
  671.                 Note that these lengths correspond to the maximum length
  672.                 allowed by RegPRO's dropfile handling system.  Should you
  673.                 deviate any shorter than these lengths, you may run into
  674.                 a problem.
  675.  
  676.                 ** NOTE ** Some of the metavariables may not be available
  677.                 for your BBS type.  This is dependant upon which type of
  678.                 BBS drop file your BBS supports.
  679.  
  680.                 More metavariables will be added in future releases.
  681.                 
  682. STRICTINPUT     Setting this flag causes the field to operate in "strict"
  683.                 input mode, which may be desirable if your input format
  684.                 contains more than one type of input. Normally, if you
  685.                 were inputting such a string, the user would be able to
  686.                 move to the middle of the string, and insert any text.
  687.                 Doing so would cause the rest of the input line to shift
  688.                 right. However, in cases where your format string specifies
  689.                 different types of characters to be permitted in different
  690.                 positions, this can cause the input to be changed so that it
  691.                 no longer conforms to the format string. In this case, the
  692.                 user's input will no longer be valid, and the user will not
  693.                 be able to exit the function by pressing [ENTER] until they
  694.                 change their input. However, when strict input mode is
  695.                 turned on, RegPRO will restrict the ways in which the user
  696.                 is permitted to edit the string, to prevent just such a
  697.                 case from occurring.
  698.  
  699. PASSWORDMODE    Setting this flag causes the field to operate in password
  700.                 mode.  In password mode, the characters typed by the user
  701.                 will be hidden, displayed instead as the blank character
  702.                 specified in the FILL parameter.
  703.  
  704. FORCEFILL       When set, this flag will force the user to enter a string
  705.                 that fills the entire length of the format string. Normally,
  706.                 the user will be able to enter a string of any length up to
  707.                 the maximum length specified by the format string. However in
  708.                 some cases, such as when inputting a date, you will want to
  709.                 have the input field filled.
  710.  
  711. AUTODELETE      When set, along with the EDITEXISTING flag, this flag will
  712.                 activate the auto-delete feature of the field.  When AUTODELETE
  713.                 is active, if the first key pressed by the user is not an
  714.                 edit control key, the existing text will be automatically
  715.                 deleted, and a totally new string accepted from the user. This
  716.                 could be useful when you are allowing the user to go back to
  717.                 edit a previous input. If the user wishes to only change part
  718.                 of the old entry, they can move the cursor to the location
  719.                 where they wish to make the change, and perform their editing.
  720.                 However, if the user wishes to completely replace the old
  721.                 string with a new one, they can simply begin to type, and the
  722.                 old string will automatically be deleted, and the new string
  723.                 accepted.
  724.  
  725. NOSKIP          This flag will inform RegPRO that this field should not be
  726.                 skipped at all.  In other words, the user will not be able
  727.                 to exit the form, without entering data in this field.  If
  728.                 the users tries to leave the form, and there are skipped
  729.                 fields with this flag set still empty, the user will be
  730.                 placed in the first "unskippable" field.
  731.  
  732. KEEPBACKGROUND  Normally, RegPRO will only display the input field background
  733.                 FILL characters while the user is editing the string, and
  734.                 will remove it when the user goes to the next field.  However,
  735.                 you may wish to continue having this field displayed after
  736.                 input has taken place, and the next field has been called.
  737.                 In this case, setting this flag will cause the background
  738.                 characters to remain visible after input has finished.
  739.  
  740. PERMALITERAL    When the format string contains literal characters (such as
  741.                 forcing a ':' character to be added to a time input by using
  742.                 the format string "##':'##':'##", the field can operate in
  743.                 one of two modes. In the default mode, the literal characters
  744.                 will only be displayed when they have been automatically
  745.                 added to the string. For instance, if you were inputting the
  746.                 current time using the above format string, this mode would
  747.                 result in the input field initially being blank. When the
  748.                 user types the first digit of the time, that number would
  749.                 appear. When the user types the second digit of the time,
  750.                 that number will appear, and then the colon character will
  751.                 automatically be added by RegPRO. However, you can also set
  752.                 field to operate in "Permaliteral" mode, by setting this
  753.                 flag.  When the PERMALITERAL flag is set, the input field
  754.                 will initially contain the literal characters (ie, the colons
  755.                 in our example), with the cursor still located at the
  756.                 leftmost position in the input field. In this mode, the
  757.                 literal characters become a permanent part of the input
  758.                 field, and can not be moved or deleted by the user - instead
  759.                 the cursor simply skips over the literal character's position.
  760.  
  761.  ┌────────────────────────────┐
  762. ▄│   Format Masks (Strings)   │
  763. █└────────────────────────────┘
  764. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  765.  
  766. In specifying the format string, not only do you specify the length of the
  767. input field, but you can also force the user's input into certain formats.
  768. For example, if you wished to input a North American style phone number, you
  769. could use a format string of "###-###-####". Then regardless of whether the
  770. user typed any dash character or not, their input would be converted, as they
  771. type, to the format of the phone number 613-526-4466. You could also specify
  772. a format string such of "MMMMMMMMMMMMMMMMMMMMMMMMMMMMMM", which would permit
  773. the user to enter a name of up to 30 characters. RegPRO would then
  774. automatically capitalize the name, so that the first character of each word
  775. is capitalized, and the remaining characters of the word are in lower case.
  776. Even if the user were to move the cursor to the middle of the string they
  777. had entered, and add or delete a space (and thus either make one word two
  778. or two words one), RegPRO will re-format the string to reflect the change.
  779. The valid characters for the format string, along with their meanings, are
  780. listed below. Note that the format string is NOT case sensitive (except for
  781. literal strings delimited by the '' or "" characters), and space characters
  782. can be added at any point to increase legibility.
  783.  
  784.  
  785.    #    Indicates that numeric characters from '0' to '9' are valid
  786.         for this position.
  787.  
  788.    %    Indicates that numeric characters from '0' to '9', and the
  789.         space character (' ') are valid for this position.
  790.  
  791.    9    Indicates that numeric characters from '0' to '9', along
  792.         with '.', '-' and '+' are valid for this position. This
  793.         format style is intended for floating-point numeric input.
  794.  
  795.    ?    Indicates that any character is valid for this position.
  796.  
  797.    *    Indicates that any printable character, from ASCII 32 to
  798.         ASCII 127, is valid for this position.
  799.  
  800.    A    Indicates that alphabetical characters 'A' to 'Z', 'a' to
  801.         'z' and space (' ') are valid for this position.
  802.  
  803.    C    Indicates that city name characters are valid for this
  804.         position. As with the 'M' format character, words are
  805.         automatically capitalized so that the first letter is in
  806.         upper case, and all subsequent letters are in lower case. In
  807.         addition to permitting alphabetical characters and the space
  808.         (' ') character, the ',' and '.' characters are also
  809.         accepted in this position.
  810.  
  811.    D    Indicates that date characters '0' to '9', '-' and '/' are
  812.         valid for this position.
  813.  
  814.    F    Indicates that MS-DOS filename characters are valid for this
  815.         position.
  816.  
  817.    H    Indicates that hexidecimal character '0' to '9', 'A' to 'F'
  818.         and 'a' to 'f' are valid for this position.
  819.  
  820.    L    Indicates that only lower case alphabetical characters 'a'
  821.         to 'z', and the space (' ') character is valid for this
  822.         position. However, if the user attempts to enter an upper
  823.         case alphabetical character in this position, it will
  824.         automatically be converted to the lower case equivalent.
  825.  
  826.    M    Indicates that name characters are valid for this position.
  827.         These characters are the alphabetical characters 'A' to 'Z',
  828.         'a' to 'z', and the space character (' '). A character's
  829.         case is converted such that the first character of a word is
  830.         in upper case, and all other letters are in lower case.
  831.  
  832.    T    Indicates that telephone number character '0' to '9', '(',
  833.         ')', '-' and ' ' are valid for this position.
  834.  
  835.    U    Indicates that only upper case alphabetical characters 'A'
  836.         to 'Z', and the space (' ') character is valid for this
  837.         position. However, if the user attempts to enter a lower
  838.         case alphabetical character in this position, it will
  839.         automatically be converted to the upper case equivalent.
  840.  
  841.    W    Indicates that MS-DOS filename characters are permitted in
  842.         this position, including the '*' and '?' wildcard
  843.         characters.
  844.  
  845.    X    Indicates that alphanumeric characters 'A' to 'Z', 'a' to
  846.         'z', '0' to '9' and ' ' are valid for this position.
  847.  
  848.    Y    Indicates that yes/no characters 'Y', 'N', 'y', 'n' are
  849.         valid for this position. The characters are automatically
  850.         converted to upper case.
  851.  
  852.    '    Single quotes can be used to specify sequences of
  853.         characters that should appear at the same location in the
  854.         input string (referred to elsewhere as "literal strings").
  855.         When the user is entering the string, these characters are
  856.         automatically supplied, and the user is not required to type
  857.         them. Literal strings must begin and end with the same quote
  858.         character.
  859.  
  860.  ┌────────────────────┐
  861. ▄│   User Edit Keys   │
  862. █└────────────────────┘
  863. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  864.  
  865. As mentioned above, RegPRO provides advanced field editing, such as inputting
  866. inputting and deleting text from the middle of the string. The edit keys are
  867. are listed below. Note that some of these may or may not be available,
  868. depending upon the capabilities of the user's terminal program. While there
  869. is no single standard used for the transmission of special edit keys such as
  870. the arrow keys, RegPRO makes as much effort as possible to make all of the
  871. edit features available to most terminal programs. Many of the edit keys
  872. can be accessed using either [CONTROL]-key combinations or special keys
  873. such as the arrow keys, delete key, and so on. RegPRO will recognize most of
  874. these special control keys when sent as either an ANSI control sequence
  875. (which is sent by most terminal programs), or as a DoorWay style scan
  876. code / ASCII code sequence (which is also available from many terminal
  877. programs, but is not usually required). The RegPRO field edit keys are as
  878. follows. Note that all edit functions are always available from the local
  879. keyboard.
  880.  
  881. HOME - Moves the cursor to the beginning of the line being
  882.           edited. Press the [HOME] key, either in DoorWay mode or
  883.           from the local keyboard.
  884.  
  885. END  - Moves the cursor to the end of the line being edited. Press
  886.           the [END] key, either in DoorWay mode or from the local
  887.           keyboard.
  888.  
  889. DELETE CHARACTER - Deletes the character under the cursor. Press
  890.           [DELete] on the local keyboard, in DoorWay mode, and
  891.           under many terminal programs without DoorWay mode.
  892.           Alternatively, press [CONTROL]-[G].
  893.  
  894. BACKSPACE - Deletes the character left of the cursor. Press
  895.           [BACKSPACE] or [CONTROL]-[H].
  896.  
  897. TOGGLE INSERT MODE - Switches RegPRO between between INSERT mode and
  898.           OVERWRITE mode. Press [INSert], either in DoorWay mode, or
  899.           from the local keyboard. Alternatively, press [CONTROL]-[V].
  900.  
  901. CURSOR LEFT - Moves the cursor left one character. Press [LEFT
  902.           ARROW] on the local keyboard, in DoorWay mode, and
  903.           under many terminal programs without DoorWay mode.
  904.           Alternatively, press [CONTROL]-[S].
  905.  
  906. CURSOR RIGHT - Moves the cursor right one character. Press [RIGHT
  907.           ARROW] on the local keyboard, in DoorWay mode, and
  908.           under many terminal programs without DoorWay mode.
  909.           Alternatively, press [CONTROL]-[D].
  910.  
  911. ERASE ENTIRE LINE - Press [CONTROL]-[Y].
  912.  
  913. ACCEPT INPUT - Press the [ENTER] / [RETURN] line to accept the
  914.           input. Alternatively, press [CONTROL]-[Z]. Note that
  915.           this key will only work when the current input is
  916.           "valid" (ie, it conforms to the format string, which is
  917.           described below)
  918.  
  919. NEXT FIELD - If enabled, allows the user to move to the next
  920.           field in a form. Press [DOWN ARROW] in DoorWay mode and
  921.           under many terminal programs without DoorWay mode.
  922.           Alternatively, press [TAB]. Note that the [DOWN ARROW]
  923.           key is NOT usually available from the local keyboard,
  924.           as it is usually used to adjust the user's remaining time.
  925.  
  926. PREVIOUS FIELD - If enabled, allows the user to move to the
  927.           previous field in a form. Press [UP ARROW]
  928.           in DoorWay mode and under many terminal programs
  929.           without DoorWay mode. Alternatively, press [SHIFT]-
  930.           [TAB] on the local keyboard or in DoorWay mode. Again,
  931.           note that the [UP ARROW] key is NOT usually available
  932.           from the local keyboard, as it is usually used to
  933.           adjust the user's remaining time.
  934.  
  935.  ┌────────────────┐
  936. ▄│   Sysop Keys   │
  937. █└────────────────┘
  938. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  939.  
  940. There are several options available to the Sysop while the user is in the
  941. RegPRO Door.  Keep in mind that not all of these keys may be useful under
  942. certain BBS systems.
  943.  
  944. [UP]/[DOWN] - Use the arrow keys to increase or decrease the
  945.               amount of time which the user has left in the door.
  946.  
  947. [Alt]-[C] -   Allows the sysop to break into chat with the user
  948.               at any time. [Alt]-[C] again, or [ESC] will end
  949.               chat mode. (Notice that the Want-Chat indicator
  950.               will also be turned off, if it was flashing. If
  951.               you are running under Apex, RemoteAccess or
  952.               QuickBBS, paging from within the door will even
  953.               cause the Want-Chat indicator to stay lit when the
  954.               user returns to the BBS)
  955.  
  956. [Alt]-[J] -   Allows the sysop to shell to DOS, if enough memory
  957.               is available. Simply type EXIT to return to the
  958.               door again.
  959.  
  960. [Alt]-[H] -   Hang up on the user. Plain and simple!
  961.  
  962. [Alt]-[L] -   This key locks the user out of the BBS. It first
  963.               hangs up on the user, and then sets their security
  964.               level to 0, to prevent them from ever logging on
  965.               again. This feature may require use of the EXITINFO.BBS
  966.               file, depending on what system RegPRO is running under.
  967.  
  968. [Alt]-[K] -   The "User Keyboard-Off" key allows the sysop to
  969.               temporarily prevent the user from typing anything
  970.               on their keyboard. This has no effect on the local
  971.               keyboard, but causes RegPRO to ignore any keystrokes
  972.               from remote.
  973.  
  974. [Alt]-[N] -   The "Sysop Next" key, this function reserves the
  975.               system for use by the sysop after the user logs
  976.               off, if RegPRO is running under an Apex or RA
  977.               1.00 or later system.
  978.  
  979. [Alt]-[D] -   "Drop to BBS" key. This function allows the sysop
  980.               to exit RegPRO and return the user to the BBS,
  981.               without hanging up.
  982.  
  983. [F1]..[F10] - The Function keys [F1] thru [F10] allows the sysop
  984.               access to various types of information on the
  985.               status line, or to turn the status line off. Note that
  986.               some of the information displayed will depend on the
  987.               type of BBS you are running, and may or may not be
  988.               available.  These keys are as follows:
  989.  
  990.                 [F1] -  Display basic user information (default)
  991.                 [F2] -  Display phone numbers and important dates
  992.                 [F3] -  Display security flags and up/download info
  993.                 [F4] -  Display system information and current time
  994.                 [F5] -  Display message info and user's settings
  995.                 [F6] -  Display chat reason and sysop's comment
  996.                 [F9] -  Display help information for sysop
  997.                 [F10] - Turn off the status line
  998.  
  999.  ┌──────────────────┐
  1000. ▄│   Command Line   │
  1001. █└──────────────────┘
  1002. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1003.  
  1004. RegPRO accepts the following parameters:
  1005.  
  1006.         -p(BBS Drop File Path)
  1007.  
  1008.         -v(ideo Mode)   0 = Direct Screen Writes
  1009.                         1 = BIOS Screen Writes
  1010.  
  1011.         -t(ask Number) (Node Number)
  1012.  
  1013.         -d(atafile name) (.CTL File name, with no extension).
  1014.  
  1015. ────────────────────────────────────────────────────────────────────────────
  1016. ■ MISCELLANEOUS ■
  1017. ────────────────────────────────────────────────────────────────────────────
  1018.  
  1019.  ┌──────────────────────────────────────┐
  1020. ▄│   Tips on Designing RegPRO Screens   │
  1021. █└──────────────────────────────────────┘
  1022. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1023.  
  1024. Although RegPRO is an extremely powerful entry form system, it may be a bit
  1025. overwhelming to some new users.  Setting up nice entry forms takes a bit of
  1026. time and patience, but well worth the extra effort.  Currently, a custom
  1027. screen designer is being developed which will make this process MUCH easier
  1028. on you, but for now, patience is still the key.  Here are a few hints to
  1029. get you started:
  1030.  
  1031. The first thing to do is break out your favorite ASCII editor (Q-Edit works
  1032. nicely, although I prefer to work with TheDraw and save it in ASCII format).
  1033. Design the entire form, including fields, and field masks (format strings).
  1034. Next, split your ASCII editor into two windows, one for your newly designed
  1035. form, and the other for your RegPRO control file.  If your editor has a nifty
  1036. feature which shows the current row and column on the status line of each
  1037. window, you're set!  To get the row and column of each field, simply hop to
  1038. your ASCII "template" file, and move the cursor to the beginning of the field
  1039. text.  Then, jump down into your RegPRO .CTL file window, and enter those
  1040. coordinates for the field.  This is a bit kludgy, but seems to help out most
  1041. folks.
  1042.  
  1043. As I said, the Screen Designer should prove to be a lifesaver in designing
  1044. these things.  Good luck!
  1045.  
  1046.  ┌───────────────────┐
  1047. ▄│   What's Next?!   │
  1048. █└───────────────────┘
  1049. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1050.  
  1051. The following are planned additions and changes for RegPRO:
  1052.  
  1053.         * Full-Fledged Screen Designer to automatically generate the control
  1054.           files!
  1055.  
  1056.         * Script language to link forms together based on answers!
  1057.  
  1058.         * Menus as well as forms!
  1059.  
  1060.         * Special Effects!
  1061.  
  1062.         * Customizeable buttons for use in form linking!
  1063.  
  1064.         * Ability to store data directly into the user's BBS record!
  1065.  
  1066.  ┌────────────────────┐
  1067. ▄│   Special Thanks   │
  1068. █└────────────────────┘
  1069. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1070.  
  1071. We would like to take time to offer our appreciation to the Cairo Research
  1072. Lab Beta Team.  Thanks guys!
  1073.  
  1074. Thanks are also in order for Brian Pirie, Diane and Madeleine, Bob Kruger,
  1075. and countless others whose efforts and caveats seem to go unnoticed at times.
  1076.  
  1077.  ┌──────────────────────────────┐
  1078. ▄│   Upgrades and Information   │
  1079. █└──────────────────────────────┘
  1080. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1081.  
  1082. For the latest version of RegPRO, or for tech support by BBS, call:
  1083.  
  1084. Under The Nile!                 Backwoods BBS
  1085. (706) 596-8126 9600 v.32        (706) 561-6106 9600 USR-DS
  1086. 1:3613/12@fidonet               1:3613/10@fidonet
  1087.  
  1088. Magic name REGPRO will get you the latest version!
  1089.  
  1090. ────────────────────────────────────────────────────────────────────────────
  1091. ■ END OF REGPRO 2.60 DOCUMENTATION ■
  1092. ────────────────────────────────────────────────────────────────────────────
  1093.